获取表的指标数据_存储层

描述

导出多张表的分钟级读写次数等各种监控指标,

注意事项

统计数据是每5分钟上报一次数据的。拉取数据的时候注意拉取的时间范围,需要等数据上报完后再拉取。

例如,当前是2025-05-01 08:00, 只能拉取到 2025-05-01 07:55前的数据。

请求地址

/v2/webservice/report/table/minute-report-data

请求方法

Post

请求参数说明

字段名字段说明类型是否必填描述参考值
app_id项目IDnumber是--2
zone_id区IDnumber是3
table_name表名string否,不填的时候表示全部user_info
report_begin_time开始时间string是开始时间和结束时间跨度不能超过7天2024-07-08,2024-07-08 00:00:00
report_end_time结束时间string是开始时间和结束时间跨度不能超过7天2024-07-09
metrics导出指标string[]否选择要查询的指标,["read_number"]

metrics的可选值

字段名字段说明单位
read_number读次数次/s
write_number写次数次/s
avg_queue_time平均排队时间微秒
avg_read_time读平均时延微秒
avg_write_time写平均时延微秒
slow_process_count慢读写次数次/min
record_read_number读记录数次/s
record_write_number写记录数次/s
large_req_count大请求数次/5min
req_bytes请求流量bytes/s
resp_bytes响应流量bytes/s
system_error_number系统错误数个/5min

请求示例, 查询从08:00分-08:05分的数据

{
    "app_id": 5,
    "zone_id": 1,
    "table_name":"BattleStatTable",
    "report_begin_time": "2024-07-08 08:00:00",
    "report_end_time": "2024-07-08 08:05:00"
}

返回data.list参数说明

字段名字段说明类型描述
app_id项目ID
zone_id
table_name
update_time
read_number读次数单位:5min/次
write_number写次数单位:5min/次
…其他指标值

成功返回 (查询fake_table表,00:00 - 00:11的读写数据)

{
    "code": 0,
    "request_id": "e56732af-e71a-46ee-88ce-0135c34ad38b",
    "data": {
        "list": [
            {
                "app_id": 5,
                "zone_id": 1,
                "table_name": "fake_table",
                "update_time": "2024-07-08 00:00:00",
                "read_number": "0",
                "write_number": "1"
            },
            {
                "app_id": 5,
                "zone_id": 1,
                "table_name": "fake_table",
                "update_time": "2024-07-08 00:05:00",
                "read_number": "0",
                "write_number": "1"
            }
        ],
        "total": 2
    }
}

失败返回, 数据不存在

{
    "request_id": "7caf2d3b-e668-4a10-9a2b-cc81eccc5e3b",
    "code": 114,
    "message": "没找到svr_rt表, 数据可能还没开始上报, 或上报程序出错",
    "debug_message": null
}

失败返回, 没权限